PICK%

Syntax: PICK% [(JobID]
    or: PICK% (JobID, action)
Location: PEX

This function can be used to perform various acts.

The first syntax is the more common and will bring the specified Job (default -1) to the top of the pile.

If JobID is -2, then the next Job in the Job Table (see NXJOB) is brought to the top of the pile - this is therefore similar to pressing <CTRL><C>.

The second variant is more complex and depends upon the values of JobID and action.

(1) If JobID refers to an existing Job and action is -4, then the screen is frozen - this is equivalent to pressing <CTRL><F5>.

(2) If JobID equals -3 and action is an existing QDOS channel number (see CHANNELS) or SuperBASIC channel number then that particular channel is unfrozen, allowing input from / output to that channel provided that the Job which owns that channel is at the top of the pile or can use background screen access under PEX.

(3) If JobID equals -4 and action is an existing QDOS channel number (see CHANNELS) or SuperBASIC channel number then that particular channel is frozen again and any attempt by a program to access that channel will (unless that program is not buried) cause that program to halt temporarily.

The values returned by PICK% are normally zero if the function is successful.

CROSS-REFERENCE:
OJOB and NXJOB allow you to find out details about a specified Job.
PEON allows background screen access.
